Skip to main content

add task

Uses​

<add task command> {[<property key> <property value>]}*
  • <add task command>
    • main command: add task
    • aliases: task add, make task, create task, task create, addtsk, mktsk
    • snippets: +t, + t, + task

ADD_TASK:​

ADD_TASK

ADD_TASK ::= ( ( 'add' | 'create' ) SPC 'task'
               | 'task' SPC ( 'add' | 'create' )
	       | 'addtsk'
	       | 'mktsk' ) ITEM_NAME? TASK_PTRS
ATTENTION

Aliases and snippets help us input the command in the command line and automatically transform it into the main command. But if you call the command in API, then use only the main command

  • <property key>
    • name | --name | -N
    • in domain | --domain | -dom
    • for project | --project | -p
    • assigned to | deligate to | --assign | -a
    • due | due on | deadline | deadline on | --due | --deadline
    • start | start on | --start | -s
    • finish | finish on | --finish | -f
    • duration | --duration | -d
    • with pritority | --priority | -P
    • with constraints | --constraints | --const
    • depends on | --after | --berfore | --with
    • recurring | --repeat | -r
    • estimated time | --estimate | -e
    • note | --note | -n
info
  • The list of properties pair can be empty or have key-values spaces-separated pairs
  • The default first key is name, which can be skipped, then the value after the command name is identified as the value of the name key. If the first key after the command name is different, then you must use the name keyword to define the start of the name value definition instruction.
  • The key-value pairs can be defined in any order

TASK_PTRS:​

name​

ITEM_NAME:

ITEM_NAME

ITEM_NAME ::= SPC ( '"' | "'" ) ANY_CHAR? ( '"' | "'" )
           |  ( SPC WORD )+

TASK_PTRS:

TASK_PTRS

TASK_PTRS ::= ( SPC DOMAIN_PTR )?
              ( SPC PROJECT_PTR )?
	      ( SPC ASSIGN_PTR )?
	      ( SPC DUE_PTR )?
	      ( SPC START_PTR )?
	      ( SPC FINISH_PTR )?
	      ( SPC PRIORITY_PTR )?
	      ( SPC RECURRING_PTR )?
	      ( SPC NOTE_PTR )?
	      ( SPC NAME_PTR )?
add task New task

or

add task "New Task"

or

add task --name New task

or

add task --name "New task"
info
  • The name's value can be enclosed in single or double quotes but can be without it (end with next keywords)
  • If the name's value define immediately after the command name, then we can omit keyword name

Uses examples​

add task

Expected result: Open the Add task dialog (pop up)

add task Make the document

or

add task "Make the document"

or

add task 'Make the document'

Expected result: Task is made in the Inbox domain and selected like as current (changed contex and ready for other actions with them)

In this example we set Make the document as value of the property name. The same result with:

task create Задача с полной информацией 
	for project "Проект Y" 
	in domain "Маркетинг" 
	assigned to "user3" 
	due on "2024-01-15" 
	depends on task 456 
	with constraints workdays only
	recurring monthly 
	with priority medium 
	estimated time "3h" 
	note "Полное описание задачи"